home *** CD-ROM | disk | FTP | other *** search
/ SuperHack / SuperHack CD.bin / CODING / SOUND / SCK_SP23.ZIP / SP32.DOC < prev    next >
Encoding:
Text File  |  1996-08-07  |  5.1 KB  |  140 lines
  1. Shock Play 2.3b Documentation
  2. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  3.  
  4. [First public release.]
  5.  
  6.  
  7. 1. What is this?
  8. ~~~~~~~~~~~~~~~~
  9.  
  10.  Guess what... A shareware S3M player for Pmode/W, which currently supports
  11.  only GUS as a wave device. I'm planning some AdLib support too, and if so-
  12.  meone throws me an AWE32 or SB16, i'll support them too.
  13.  
  14. 2. Why the hell should I use it?
  15. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  16.  
  17.  Well, kinda obvious that a player must be fast. And this is FAST,  really,
  18.  coz it contains no C routines as many others, like Midas and the rest. And
  19.  the most useful function is memory doubling. I haven't  seen a  decent S3M
  20.  player with memory doubling so far. I mean those ones which come w/ source
  21.  too. I can't imagine that the authors of Midas and MikMod can't write some
  22.  kind of memory-doubling feature! I hate when some  demos  just won't start
  23.  because  I've got a  768K GUS (and more some got even 256K GUSes!).  Ok, I
  24.  decided to code a player for those people. Maybe you need this too.
  25.  
  26. 3. Why just only S3M?
  27. ~~~~~~~~~~~~~~~~~~~~~
  28.  
  29.  Ok, some XM support is on its way, but I  really like ST3,  coz I hate the
  30.  mouse-driven interface of FT2.  I'm a (not-too-good)  musician too,  and I
  31.  personally like ST3 for its ease of use.
  32.  
  33. 4. Does it support all the S3M effects?
  34. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  35.  
  36.  Basically all you need is here.  Ok,  for example Vibrato is not supported
  37.  yet, but it will be in the next version, and  we really don't use it.  But
  38.  who knows? Pattern jump is also not supported. Have you ever used it? ;-))
  39.  
  40. 5. Is it easy to use?
  41. ~~~~~~~~~~~~~~~~~~~~~
  42.  
  43.  Of course!! ;-)  What you need is: load a S3M somewhere, and call SP_START
  44.  given with the pointer which points to the loaded S3M. That's all.  If you
  45.  want silence, just call SP_STOP.  How easy! No setup needed.  No  giggling
  46.  with DMAs and IRQs. Full autodetect or what!
  47.  
  48. 6. Ok, here is a list of the commonly used procedures and variables
  49. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  50.  
  51.  SP_START(byte *modplace)             - starts playing
  52.  SP_STOP()                            - stops playing
  53.  SP_SETCALLBACK(dword whattocall())   - callback function (really useful!)
  54.  SP_POLLMUSIC()                       - for debugging, manual call of player
  55.  
  56.  SP_ACTROW                            - which is the actual row
  57.  SP_ACTORDER                          - which is the actual order
  58.  
  59.  If  you  need more, just have  a look  at the source.  It's  really  self-
  60.  explanatory. Public and extern them, and be happy.
  61.  
  62. 7. I'm lame! I still can't understand!
  63. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  64.  
  65.  Have a look at the SP.C, and SP.H.  You should understand how it works, or
  66.  gotta go to collect stamps or what!
  67.  
  68. 8. But I need a MOD player (even a 16CH MOD player!)
  69. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  70.  
  71.  It's already done. If you really need that,  I'm  gonna  include it in the
  72.  next version.
  73.  
  74. 9. Can you send me a Realmode version?
  75. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  76.  
  77.  Yes, of course. Some years ago I wrote a realmode player too (GUS/S3M). If
  78.  you really need that, I can send it to you.
  79.  
  80. 10. Will you convert it to plain PMODE?
  81. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  82.  
  83.  Probably not. Do it yourself!
  84.  
  85. 11. What will be in the next version? And when?
  86. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  87.  
  88.  Dunno when. If I get reactions then SOON! Anyways:
  89.  
  90.  - SB16, AWE32 support
  91.  - MOD 4-16 channels support (if someone needs it)
  92.  - XM support
  93.  - full set of commands
  94.  
  95. 12. Good! But does this cost me money? Or can I use it freely?
  96. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  97.  
  98.  It's totally free. Do what you want, but please don't spread the  modified
  99.  versions. Only the original.
  100.  
  101. 13. I discovered that if I press F1 in the player interface, I can see that
  102. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  103. some CyberDancer wrote it, not TSC! Are you a ripper?
  104. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  105.  
  106.  Noo... Just it was my previous handle. And since  the  original   ansi was
  107.  lost, I can't redraw it anymore  (ok, ok,  i  could  someway, but I simply
  108.  don't care. This player is just a simple example. Understood?!)
  109.  
  110. 14. I've got no more questions!
  111. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  112.  
  113.  Good... At last!
  114.  
  115. 15. Ooops. I've almost forgotten: How can I reach you!??
  116. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  117.  
  118.  Fuck. Call me:  +36-62-341850 (ask Gábor)
  119.  
  120.        Write me: tsc@master.fok.hu
  121.                  szabogab@gandalf.gamf.hu
  122.  
  123.        Irc:      #magyar, #teensex ;-)
  124.  
  125.        Snailmail: Szabó Gábor
  126.                   6800 Hódmezôvásárhely
  127.                   Somogyi Béla u. 26.
  128.                   Hungary
  129.  
  130.        BBS:       Write to tsc on: JunkDrome, Dune][, Scenet, Da Lost Grid
  131.                                    Brain Core Revolvator, Apocalyptic Raids,
  132.                                    Electric Ladyland
  133.        Or find me
  134.        on:        FidoNet/RetteNet/Erratic CyberWorld
  135.  
  136. 16. That's enough... Stop it now!!
  137. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  138.  
  139.  Go to the hell...
  140.